Migrate an Audience

Overview

The API Comparison table highlights the main actions and API methods for creating and managing Audiences. Select an endpoint from IQM or DV360 to review that platform's relevant API documentation. By comparing APIs, you can migrate your workflow from DV360 to IQM.

Definitions

IQM	DV360	Description
Audience	Audience	The group of people targeted for a Campaign. Audiences comprise included/excluded demographic data which are used to optimize targeting.
Audience Segment	Audience Segment	A group of specified Segments with optimization settings.
Segment Group	Segments	The demographic characteristics by which a group of people can be identified, organized, and combined into Audience Segments.
Matched Audience	Customer Match	A customized Audience that you've created and uploaded to the platform.
Pre-bid Audience	Third Party Audience	An Audience composed of segments that have been sent to the platform by third-party data providers that you can purchase and target in your Audiences.
Geo-Farmed Audience	Geo Region Targeting	An Audience created based on a customizable geographic location rather than demographic data.
Contextual Audience	Keyword Targeting	An Audience generated by keywords or URLs, based on user activity.
Retargeted Audience	Tag Based Audience	An Audience created by tracking tag conversions that retargets users who visit the tracked site.
Campaign Audience	Activity Based Audience	An Audience created by users previously targeted by a Campaign.

API Comparison

Base URLs

  IQM: https://app.iqm.com
  
  DV360: https://displayvideo.googleapis.com

Action	IQM Endpoint	DV360 Endpoint	Notes
Get Audience Details	GET/api/v2/audience/matched/{id} GET/api/v3/audience/segment/{audienceId} GET/api/v3/audience/retarget/{retargeted_audience_id} GET/api/v3/audience/campaign/{campaign_audience_id} GET/api/v3/audience/prebid/{prebidAudienceId}	GET/v3/firstAndThirdPartyAudiences/{firstAndThirdPartyAudienceId} GET//v3/googleAudiences/{googleAudienceId}
Create an Audience	POST/api/v2/audience/matched/add POST/api/v3/audience/segment/add POST/api/v3/audience/retarget/tag POST/api/v3/audience/campaign/add POST/api/v3/audience/prebid/add	POST/v3/firstAndThirdPartyAudiences	IQM features different Audience creation endpoints to distinguish types of Audiences and the Segments they are composed of. See the Audience API Guidelines for more information. DV360 specifies type by audienceType.
Update an Audience	PATCH/api/v2/audience/matched/update/{matched_audience_id} PUT/api/v3/audience/segment/{audienceId} PUT/api/v3/audience/retarget/{retargeted_audience_id} PUT/api/v3/audience/prebid/{prebidAudienceId}	PUT/v3/firstAndThirdPartyAudiences/{firstAndThirdPartyAudience.firstAndThirdPartyAudienceId}
Create a Contextual Audience	POST/api/v3/audience/contextual/add	POST/v3/advertisers/{advertiserId}/insertionOrders/{insertionOrderId}/targetingTypes/{targetingType}/assignedTargetingOptions	DV360 uses TARGETING_TYPE_KEYWORD to create a Contextual Audience.
Create a Geo-Farmed Audience	POST/api/v3/audience/geo-farmed/add	n/a

More Campaign Resources

IQM:

• Audience API
• Upload a Matched Audinece (Quickstart Guide)
• Selecting your Audiences (Help Center Article)

DV360:

• Audiences (Help Center Article)
• Target Audiences
• Audience Types
• Upload Customer Match Audiences